home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / dev / lang / nrcobol_1e.lha / NRCOBOL1e / NRCOBOL.readme < prev    next >
Text File  |  1998-09-22  |  25KB  |  669 lines
  1. NRcobol Version 1.0e  by cHArRiOTt September 98
  2.  
  3.  
  4.  
  5.   1.Introduction
  6.   2.Installation
  7.   3.Usage
  8.   4.Syntax
  9.   5.Implemented?
  10.   6.History
  11.   7.Todo
  12.   8.Bugs
  13.   9.Feedback
  14.  10.Contacts
  15.  11.Distribution
  16.  12.Credits
  17.  13.Disclimer
  18.  
  19.  14.Apologies
  20.  15.Thanks
  21.  16.finally
  22.  
  23. NUff REsPEct.....peace n more time.
  24.  
  25. -------------------------------------------------------------------------
  26.    1.Introduction ...Why COBOL?
  27.  
  28.  
  29. To those of you thinking not another new language, COBOL is in fact one
  30. of the oldest high-level languages, its roots going back to the late
  31. 1950's. Ofcourse there are those of you who already know this but regard
  32. COBOL as not so much an high-level language, as the original computer
  33. virus. To these people i say RESPECT the source of the mother tounge. (sic!)
  34.  
  35. When so many languages have come and gone (what ever happended to
  36. Modulus II, and who outside of the Amiga community has heard of 'E;), COBOL
  37. (with the most source code on the planet, circa 89) has seen in the advent
  38. of STRUCTURED,and now OBJECT methodologies, its adapted absorbing the latest
  39. in Database Management, SQL etcetera, and gone on from strength to strength.
  40. Indeed as an introduction to records there's alot to be said in its favour.
  41. So when people say why, i say why not?
  42.  
  43.  
  44. This implementation of COBOL is largely ANSI 85 compatable and takes the
  45. form of MicroSoft(TM) COBOL, with maybe the exception of some stuff in
  46. ENVIRONMENT DIVISION - SPECIAL-NAMES. And some stuff left over from the days
  47. when memory was premium and no one had the imagination to contemplate speed.
  48. see Implementation?
  49.  
  50.  
  51. This would have been bought to you sooner, if it weren't for the moron, in
  52. the bedsit down stairs, with something of an habit!! which in lean times
  53. even extend to a fixation with gas. 'would you adam n eve it'.
  54.  
  55. WARNING dope really @&*$% you up! something to do with short term memory
  56. going to pot!
  57.  
  58.  
  59.  
  60. STOP THE PRESS!.
  61.  
  62. "COMPUTING" MAY 8th 97
  63.  
  64. 'Cobol crisis looms' The skills cris is luring Cobol programmers out of
  65. retirement with offers  of up to £1000 ($1700) per day......  hmm :-)
  66.  
  67.  
  68.  
  69. -------------------------------------------------------------------------
  70.    2.Installation
  71.  
  72.  
  73. Nothing could be simpiler, Just copy the runtime program 'RUNCOB' anywhere
  74. in your path, that's ram: c: or in the same directory as the created .INT
  75. files.
  76.  
  77. Files with the extension .INT are created as a result of successfully
  78. running NRCOBOL ..see Usage
  79.  
  80.  
  81.    There are several ToolTypes which you'll need to tailor to suite your
  82.    system. To access these single click on the icon of NRCOBOL, then select
  83.    information from the sysem menu to find the following:
  84.  
  85.    TEXTEDITOR=C:ed
  86.        edit cobol source file.
  87.  
  88.    TEXTVIEWER=sys:utilities/multiview
  89.        view list / debug files, if not set then the editor set for TEXTEDITOR
  90.        is used.
  91.  
  92.    SOURCEDIR=
  93.        where cobol source files are to found by NRCOBOL's requester
  94.    RUNCOBDIR=
  95.        where runcob prog is to be found, default ram: c: or current directory
  96.        Note: the absence of a space after the '=' and in the case of SOURCEDIR
  97.        and RUNCOBDIR if a directory is stated it should end with ':' or '/'
  98.  
  99.    To avoid those moments of head scratching, you are advised to use ABSOLUTE
  100.    path names.  see.. 15.Thanks
  101.  
  102.  
  103.    If you are one the few who haven't yet discovered 'UrouHack' by Tinic Urou
  104.    then i urge you to get hold of a copy aminet util/wb. This prog redefines
  105.    the system gadgets to very impressive xen like gadgets and leaves the rest
  106.    of the system looking like MUI, and then some, without slowing the system
  107.    down. If that's not reason enough, it also improves the appearence of this
  108.    prog :)
  109.  
  110.  
  111.  
  112. -------------------------------------------------------------------------
  113.    3.Usage
  114.  
  115.  
  116. After creating your cobol source file with your favourite text editor,
  117. and saving it with the .COB extention you have a choise of evoking the
  118. compiler from CLI/shell or Workbench.
  119.  
  120. From CLI/SHELL
  121.  
  122.      NRCOBOL <sourcefile>.(COB | CBL) [-l] [-d] [-e]
  123.  
  124. where the optional flags:
  125.  
  126.      -l   produces a simple listing  <sourcefile>.LST
  127.      -d   produces a debug  listing  <sourcefile>.DBG
  128.      -e   errors ignored when compiling with wildcard option
  129.  
  130. The wildcard pattern match option will now recognize #?.(cob|cbl)
  131.  
  132. A successfull compilation produces <sourcefile>.INT
  133. to run type...  RUNCOB <sourcefile>.INT
  134.  
  135.  
  136.  
  137.  
  138. From Workbench
  139.  
  140.      Use of the program from workbench is self explanatory, but for those
  141.      too dim.
  142.  
  143.  
  144.      +-----------------------------------------------+
  145.      |                                          [.][#]
  146.      |+--------------------------------------------+-|
  147.      ||Titles                                     || |    <-- What When Who
  148.      ||                                           || |
  149.      ||                                           || |
  150.      |+-------------------------------------------+| |
  151.      |File: |                                     || |    <-- current sourcefile.COB
  152.      |      +-------------------------------------+| |
  153.      |____________________________________________ | |
  154.      ||                                           || |
  155.      || IDENTIFICATION                 *          || |    <-- status block
  156.      || ENVIRONMENT                    *          || |         *'s replaced by
  157.      || DATA                           *          || |        PASSED or FAILED
  158.      || PROCEDURE                      *          || |
  159.      ||                                           || |
  160.      ||                                           || |    <-- current line
  161.      |+-------------------------------------------+| |
  162.      |+--------+ +-+      +---+       +--+ +------+| |    <-- ancillary output files
  163.      ||        | | | List +---+ Debug +--+ |      || |        as  .LST  and/or .DBG
  164.      ||COMPILE | |>| +--------+ +--------+ |EDITOR|| |
  165.      ||        | | | |  ABORT | |  RUN!  | |      ||_|
  166.      |+--------+ +-+ +--------+ +--------+ +------+|=|
  167.      +---------------------------------------------+-+
  168.  
  169.           ^       ^                           ^
  170.           |       |                           |
  171.           |       |             Edit sourcefile.COB/LST/DBG
  172.           |   filerequester
  173.     Make it so #1
  174.  
  175.  
  176.    The Editor option allows one to view sourcefile.COB, sourcefile.LST or
  177.    sourcefile.DBG. The file editor defaults to 'ED' as supplied in sys:c.
  178.    You can however, set TEXTEDITOR in NRcobol's icon to launch your favourite
  179.    editor. eg  TEXTEDITOR=c:ced . Note no space between = and editor named.
  180.    see.. 2.Installation
  181.  
  182.  
  183.    The menu options allow:
  184.  
  185.      1, A window on a custom screen, ie high resolution non interlace or
  186.         a window on the current public screen.
  187.      2, The date check on debug/listing files can to be disabled, 
  188.         ie, open the last debug/listing file related to current cobol source file,
  189.         regardless of the date on the source file.
  190.      3, Terminal runtime check on SIZE ERROR condition.
  191.  
  192.  
  193.  
  194.    For those of you looking to automate compilation, possibly using
  195.    Arexx, the following codes are now returned by NRCOBOL:
  196.  
  197.       8000  nrcobol ?   called
  198.       8001  filename    error
  199.       8002  compilation error
  200.       8003  savefile    error (.int or T:debug_) file
  201.       8004  identifier  limits
  202.       8005  too many files found with wildcard.  [500 max]
  203.       1002  memory      error
  204.  
  205.  
  206. In both cases an ICON is produced named <sourcefile>.INT
  207. to execute just double click.
  208.  
  209.  
  210. The debug option produces a file which you may find useful in locating
  211. runtime errors, which sadly is normal for cobol. Usually this is to do with
  212. uninitialised variables, you know, finding alpha data in a numeric field.
  213.  
  214. Runtime errors usually return a value in the form 0x????, where 0x???? is an
  215. offset into the data space allocated in the Data Division. Stradling values,
  216. ie value between offset values indicates a postion within a table,
  217. (a subsripted identifier).
  218.  
  219.  
  220. -------------------------------------------------------------------------
  221.    4.Syntax
  222.  
  223.  
  224.    I may at a later date add the syntax, in the mean time the following
  225.    books are recomended:
  226.  
  227.  
  228.    -  COBOL for the IBM Personal Computer by kip R Irvine
  229.  
  230.    -  COBOL for the 80's                  by J Wayne Spence
  231.  
  232.    -  Structur